home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 8 / QRZ Ham Radio Callsign Database - Volume 8.iso / mac / files / p_thenet / x1j.exe / README.TXT < prev    next >
Text File  |  1993-08-12  |  9KB  |  199 lines
  1. This disk contains the distribution version of TheNet X-1J.
  2.  
  3. 1. Hardware Requirements
  4.  
  5.      The  software  runs in a Z80 based TNC2 or similar clone  such  as  the 
  6.      BSX2.  It  is installed as described in the bankswitch mods  file,  but 
  7.      essentially  all it needs is a single piece of wire from pin 8  of  the 
  8.      modem disconnect header to pin 1 of the EPROM.
  9.  
  10.      The  EPROM needed is a 27512, rather than the 27256 of a  normal  TNC2. 
  11.      Pin  1  of  the  EPROM is bent out from the  socket  and  connected  as 
  12.      described above.
  13.  
  14.      The  TNC  needs  to be set to the higher clock speed of 4.9  MHz  as  a 
  15.      minimum.  Whilst this version of TheNet is more efficient than  others, 
  16.      it is not sensible to run at the slower speed.
  17.  
  18.      The TNC needs at least 32K bytes of RAM.
  19.  
  20.      The  TNC needs to have DCDB from the SIO/0 connected to pin 23  of  the 
  21.      RS232  connector. See the section on RS232 later in this note for  more 
  22.      information.
  23.  
  24. 2. Installing over TheNet X previous versions
  25.  
  26.      If you are replacing a previous ROM with TheNet in it, be sure to do  a 
  27.      coldstart ( you may need to remove the battery link to force this ).
  28.  
  29. 3. Files
  30.  
  31.      The files on this disk are :
  32.  
  33.           readme.*       This file
  34.           thenet1.x1J    Part 1 of the code
  35.           thenet2.x1j    part 2 of the code
  36.           configur.*     Installation guide
  37.           userguid.*     A user's guide to the node
  38.           overview.*     The sysop's manual
  39.           patch.exe      A windowing driven patcher for thenet?.x1j
  40.           quickref.*     A handy quick reference guide
  41.           intel.exe      An Intel hex file dump utility
  42.           intel.c        The source of the above
  43.           motorola.exe   A Motorola S1 type file dumper
  44.           motorola.c     The source of the above
  45.           bankswit.*     Information on the hardware bankswitching
  46.           intro.*        The brief release note
  47.           devmeter.*     Details on the deviation meter
  48.  
  49.       The files marked '*' above come in two versions :
  50.  
  51.           .TXT           Straight ASCII text
  52.           .DOC           MS Word for Windows 2.0 format
  53.  
  54.       They contain the same text with the exception of the DEVMETER,
  55.       as the ASCII version of this file omits the circuit diagrams.
  56.       DEVMETER.DOC contains the diagrams as embedded drawings.
  57.       The file SEPARATE.DOC is just a set of section header sheets.
  58.  
  59. 4. Using it with a TCP/IP system
  60.  
  61.      One  of the reasons for the inclusion of the IP router was to help  the 
  62.      development of IP networks. This is in two different ways :
  63.  
  64.      * It allows a IP station that does not run 24 hours to run 
  65.        an IP router for the others in the area without leaving the 
  66.        PC running,
  67.      * It allows existing nodes to double as IP routers.
  68.  
  69.      In  scenario  1, where a station runs a TNC2 clone with a KISS  ROM  or 
  70.      similar,  this software may be used instead of the KISS ROM. It  should 
  71.      be configured to run KISS, Selective Copy on the RS232 port.
  72.  
  73. 5. The other version
  74.  
  75.      The  version  that includes the HIGH and LOW commands is  not  included 
  76.      here.  It used a form of bankswitching that clashes with the  deviation 
  77.      meter.
  78.  
  79. 6. Problems
  80.  
  81.      A long standing problem with the software was its tendency to crash  on
  82.      reset. I think I have now cured it.  It was caused  by  an  interaction
  83.      between  the  bankswitching  logic and the  interrupt  routines  during
  84.      reset.  It should not happen now  - tell me if it does -  but please be
  85.      certain  that  it  was not caused by some other fault  such  as  wiring
  86.      errors  or installing over a previous version without clearing the  RAM
  87.      first.  You  should still take care to use fast enough  parts  for  the
  88.      clock rate.
  89.  
  90.  
  91.      One  common  problem. If your node appears to 'lose' nodes,  look  very 
  92.      carefully  at  the  rates of node broadcasts and  the  setting  of  the 
  93.      algorithm control. The RS232 rate should be faster than the radio  rate 
  94.      or it should be set to zero, and the alternative algorithm should  only 
  95.      be enabled on the RS232 port if at all. Try switching it off to see  if 
  96.      that helps.
  97.  
  98.      The  patcher has been altered. The code now comes as two parts and  the 
  99.      patcher patches both at the same time. It needs & expects to be able to 
  100.      access both parts.
  101.  
  102. 7.   RS232 connections
  103.  
  104.      It is important that you understand the RS232 connections.
  105.  
  106.      The RS232 port will operate in one of two basic modes, a dumb  terminal 
  107.      mode  and a protocol mode. Each of these modes has two basic  types  of 
  108.      operation. These are detailed further below.
  109.  
  110.      The  decision  as  to whether the node operates  in  dumb  terminal  or 
  111.      protocol  mode depends on the setting of the DCDB input of  the  serial 
  112.      communications  chip ( the SIO/0 ). In TNC2 clones, this is the  signal 
  113.      on  pin  23 of the RS232 connector, but in most TNCs you will  need  to 
  114.      either  insert  a  link or a piece of wire, as  detailed  in  your  TNC 
  115.      manual. After connecting the links if needed, then leaving pin 23  open 
  116.      circuit  will  cause  the TNC to operate in  dumb  terminal  mode,  and 
  117.      setting  it to a negative voltage ( ie connecting it to pin 10  )  will 
  118.      cause it to operate in protocol mode.
  119.  
  120.      If  you use a BSX2 TNC, then you should connect pin 23 to pin 7  rather 
  121.      than pin 10 for protocol mode. You will also need to insert a link into 
  122.      JMP14 & make sure there is no jumper in JMP9.
  123.  
  124.      If  you  use  one of the other common TNC2 clones  such  as  the  PK80, 
  125.      MFJ1270, TNC-200 etc, then I understand ( but cannot confirm ) that you 
  126.      will  need  to  connect a wire from JMP9 pin 1,2 or 3 -  they  are  all 
  127.      joined on the PCB - to RS232 pin 23.
  128.  
  129.      Incidentally, don't forget to increase the watchdog timer capacitor  to 
  130.      give a 1 minute timeout ( C31 to 47uF in TNC2 clones ).
  131.  
  132.      Finally,  the  protocol modes are CROSSLINK or KISS,  selected  by  the 
  133.      firmware, and the dumb terminal modes are STANDARD or MODEM, again  set 
  134.      by  firmware.  In  the MODEM mode, hardware  handshaking  is  used  for 
  135.      connect  request  /  disconnect.  This  is  NOT  the  usual  method  of 
  136.      operation. Unless you are certain you understand, DO NOT use this  mode 
  137.      !.
  138.  
  139. 8. Introduction to nodes
  140.  
  141.      If  you have not used a TNC based node before, the following  notes  on 
  142.      the operation of the 'dumb terminal' port may be of use.
  143.  
  144.      When  pin  23 on the RS232 interface is high, and with  a  terminal  or 
  145.      terminal  emulator  on  the RS232 port, the node  will  not  appear  to 
  146.      respond to anything. If you send an 'escape' character, the node should 
  147.      respond  with  a '* '. If it does not, look at the TNC status  LED.  It 
  148.      should be dimly lit with a little bit of a flicker. If not, the node is 
  149.      not  operating.  If it is, you have an RS232 problem.  If  you  receive 
  150.      unsolicited  garbage  whenever the TNC receives data, you have  pin  23 
  151.      tied low and you are receiving crosslink or kiss frames.
  152.  
  153.      If  it does respond with a star and a space, you can now type one of  3 
  154.      characters - C, D or P.
  155.  
  156.      P will display or change the current password.
  157.      D will disconnect you from the node.
  158.      C will connect you to the node.
  159.  
  160.      Try  the  C  command. You should get a  'connected'  message.  Hit  '?' 
  161.      followed by return and you will get a list of all commands.
  162.  
  163.      Escape commands only work on the RS232 port when in dumb terminal mode. 
  164.      Don't  forget  to disconnect from the node before  you  disconnect  the 
  165.      terminal. 
  166.  
  167. 9. 'User channel' nodes
  168.  
  169.      To  create  a  'user  channel' node (  ie  one  that  supports  Net/Rom 
  170.      protocols  on  its  RS232  port but not on its Radio  port  ),  do  the 
  171.      following :
  172.  
  173.      * Set the radio port default quality to one less than minqual
  174.      * Bar  node  broadcasts  on the radio port by  setting  MODE  parameter 
  175.        number four to 2
  176.      * Ensure that no manual routes exist in the route table for port 0.
  177.  
  178. 10. EADG Nodes
  179.  
  180.      If you put a node up in the UK that can be heard from East Anglia,  may 
  181.      I encourage you to put the QRA locator in the Beacon text to enable the 
  182.      G1TLH  Beacon  analysis  program to report  accurately  on  propagation 
  183.      conditions.
  184.  
  185.  
  186. 73's
  187.  
  188. Dave G8KBB @ GB7MXM.#36.GBR.EU
  189. [44.131.16.31] g8kbb.ampr.org
  190.  
  191. 7, Rowanhayes Close
  192. Ipswich
  193. IP2 9SX
  194. England
  195.  
  196. Tel    0473 682266
  197.     +44 473 682266
  198.  
  199.